home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / os2 / hpdf_102.zip / README.1ST < prev   
Text File  |  1994-05-08  |  5KB  |  123 lines
  1. HPFSDFRG.EXE - Defragment files on an OS/2 HPFS drive.
  2.  
  3. Author: Jack Grey: Compuserve [76040,342], jackgrey@iglou.com
  4.  
  5. Written: December 1993.
  6.  
  7. Compiled February 1994 with the GNU C Compiler version 2.5.8 for EMX 0.8H
  8. with EMX libraries at patch level 5. The EMX .DLL files are not required.
  9.  
  10. Updated May 1994 GNU C 2.5.8, EMX 0.8H patch level 6. Added open file skip
  11. and preservation of state of the Archive flag bit. Previous versions set all
  12. files as unarchived, interfering with certain backup programs/procedures.
  13. Open file skip allows partial defragmentation of a partition containing open
  14. or locked files.
  15.  
  16. ----------------------------------------------------------------------------
  17.  
  18. DISCLAIMER:
  19. -----------
  20.  
  21. In consideration of the use of this program, all USERS ACKNOWLEDGE
  22. THAT THERE ARE NO WARRANTIES AS TO MERCHANTABILITY OR FITNESS FOR
  23. A PARTICULAR PURPOSE AND USERS ACCEPT THE RESPONSIBILITY TO TAKE
  24. SUCH STEPS AS THEY DEEM NECESSARY TO PROTECT THEIR SYSTEMS AND DATA.
  25. THE AUTHOR CANNOT BE LIABLE FOR ANY LOSSES OCCURRING AS A RESULT OF
  26. THE USE OF THIS PROGRAM.
  27.  
  28. YOU USE THIS PROGRAM ENTIRELY AT YOUR OWN RISK.
  29.  
  30. ----------------------------------------------------------------------------
  31.  
  32. Usage: hpfsdfrg <directory name with terminating slash> [-s] [-r]
  33.  
  34. -s parm will do all directories below as well
  35.  
  36. -r parm will cause open/in-use files to be skipped, allowing partial
  37.    defragmentation of active volumes.
  38.  
  39. Examples:
  40.  
  41. Dir \temp1\ only:                       hpfsdfrg \temp1\
  42.  
  43. Dir \temp1\ and its subdirectories:     hpfsdfrg \temp1\ -s
  44.  
  45. Entire current drive:                   hpfsdfrg \ -s
  46.  
  47. Entire current drive, skip open files:  hpfsdfrg \ -s -r
  48.  
  49. ----------------------------------------------------------------------------
  50.  
  51. IMPORTANT USAGE INSTRUCTIONS! READ PRIOR TO USING HPFSDFRG!
  52. -----------------------------------------------------------
  53.  
  54. As with any utility that makes major changes to files, it is recommended that
  55. DATA BE BACKED UP PRIOR TO THE USE OF HPFSDFRG.
  56.  
  57. This program is most effective when files are not opened or locked by system
  58. processes. As such, in order to fully defragment a partition, it is recommended
  59. that the system be booted from another partition or floppy disk and the program
  60. itself be loaded from a source other than the target drive. If an open or locked
  61. file is encountered, the program will terminate unless the -r parameter is
  62. specified. If -r is specified, a message indicating that a file was skipped is
  63. displayed.
  64.  
  65. The program has been tested under OS/2 2.1 GA and OS/2 2.11 with both HPFS.IFS
  66. and HPFS386.IFS on 80386 and 80486 systems with HPFS partitions as large as
  67. 2 gigabytes.
  68.  
  69. However, IT HAS NOT been tested on IBM Lan Server/Microsoft Lan Manager drives
  70. containing ACL information. As such, please proceed with caution in these
  71. environments. The author would be interested in feedback regarding the use of
  72. hpfsdfrg in these environments.
  73.  
  74. The program sets write verify on during execution. It is recommended that a
  75. minimum-sized HPFS cache be allocated and that the Lazy Write option be set to
  76. OFF ( CACHE /LAZY:OFF or CACHE386 /LAZY:OFF ) prior to running hpfsdfrg.
  77.  
  78. Files flagged System, Hidden, or ReadOnly are not processed.
  79.  
  80. There must be free space available on the drive greater than the size of
  81. the largest file processed by hpfsdfrg.
  82.  
  83. Finally, DO NOT INTERRUPT THE PROGRAM BY PRESSING CTRL-BREAK OR CTRL-C!
  84. DOING SO MAY RESULT IN CORRUPTION OF THE FILE BEING PROCESSED AT THE TIME.
  85. Pressing the ESCAPE key will cause the program to terminate after completing
  86. processing of the current file.
  87.  
  88.  
  89. HOW IT WORKS:
  90. -------------
  91.  
  92. Each file processed is copied to a temporary file named '~~~~~~~~.$$$' in the
  93. current directory. If the copy is successful, the original file is deleted and
  94. the temporary file is renamed to the original file's name. Date stamps and
  95. extended attributes are preserved.
  96.  
  97. The program takes advantage of the HPFS property of attempting to create a file
  98. in a contiguous area of free space on the drive. However, a file may not be
  99. fully defragmented if there is not a contiguous space greater than or equal to
  100. the size of the file. In any case, a minimal number of fragments will be used.
  101.  
  102.  
  103. RECOVERY:
  104. ---------
  105.  
  106. Every effort has been taken to avoid data loss. The program will terminate
  107. if it is able to detect an error condition during execution. However, in the
  108. event the renaming of the temporary file fails, the program will terminate
  109. and the temporary file will remain in the directory being processed at the
  110. time of failure. The name of the file being processed will be displayed and
  111. the user may attempt to recover by manually renaming the temporary file to
  112. the original file name. ONCE AGAIN, PLEASE BACK UP YOUR DATA PRIOR TO USING
  113. HPFSDFRG.
  114.  
  115.  
  116. DISTRIBUTION:
  117. ------------
  118.  
  119. The author offers this program to the public domain for distribution in
  120. unmodified form with all files contained in the archive HPDF_102.ZIP. This
  121. documentation file must be included.
  122.  
  123.